DrawThemeTrack

DrawThemeTrack
Header:	Appearance.h		Carbon status:	Supported

Draws a track.

OSStatus DrawThemeTrack (
    const ThemeTrackDrawInfo *drawInfo, 
     rgnGhost, 
    ThemeEraseUPP eraseProc, 
    UInt32 eraseData
);

drawInfo: A pointer to a structure of type ThemeTrackDrawInfo. Before calling DrawThemeTrack, set the structure to contain the current visual characteristics of the track.
rgnGhost: A value of type RgnHandle. If the track is of a type that contains an indicator, such as a scroll bar or slider, you may pass a handle to the region where DrawThemeTrack is to draw a ghost image of the track indicator. Your application should only use a ghost image with the indicator when a track does not support live feedback. Pass NULL if you do not want to draw a ghost image.
eraseProc: A value of type ThemeEraseUPP. If you have a custom background, pass a universal function pointer to an application-defined function such as that described in ThemeEraseProcPtr. DrawThemeTrack calls that function to erase the background before drawing the track. If you pass NULL, no erasing occurs.
eraseData: An unsigned 32-bit integer. Provide any data to be passed in to the callback function specified in the eraseProc parameter.

function result: A result code.

DISCUSSION

Your application may use the DrawThemeTrack function to draw a theme-compliant slider, progress bar, or scroll bar. If you use DrawThemeTrack to draw a scroll bar, use the function DrawThemeScrollBarArrows to draw the scroll bar’s arrows. If you use DrawThemeTrack to draw a slider, use DrawThemeTrackTickMarks to draw any tick marks for the slider.

VERSION NOTES

This function is available with Appearance Manager 1.1 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.